.TH E1432_TRIGGER_MEASURE 3 E1432
.SH NAME
e1432_trigger_measure \- Manually trigger an E1432
.IX e1432_trigger_measure(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_trigger_measure(E1432ID hw, SHORTSIZ16 ID,
                                 SHORTSIZ16 wait_after)
.cE
.SH DESCRIPTION
\fIe1432_trigger_measure\fR moves all modules in the group from the
\fBTRIGGER\fR state to the \fBMEASURE\fR state.

This function performs a "manual trigger", and does not need to be
called when either one of the module in the group is set to
"auto-trigger", or any of the channels in the group is set as an
active trigger source.  See the "Measurement setup and control"
section earlier in this manual, for a detailed description of the
measurement states.

This function waits for all modules to be in the \fBTRIGGER\fR state,
before proceeding further, and returns an error if this state is not
reached after a limited time.  After the call to
\fIe1432_trigger_measure\fR completes successfully, the measurement
moves to the \fBCONVERT\fR state, and will stay here until a block is
acquired.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.
If the measurement involves more than one module, it is mandatory that
a \fIgroup ID\fR be used, rather than a \fIchannel ID\fR.

\fIwait_after\fR determines whether this function will wait for the
module to actually move beyond the \fBTRIGGER\fR state.  If zero, the
function does not wait; if non-zero, the function waits.
.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_arm_measure, e1432_init_measure
.ad
